Codex 直连Deepseek新手教程

文档用途：Codex 客户端接入 DeepSeek 大模型
适用人群：普通用户，层级轻量化
兼容客户端：Codex CLI / ChatGPT 桌面端 / VS Code Codex 插件

​

📌 前置准备

• deepseek-v4-flash：立即可用，日常编码首选
• deepseek-v4-pro：超强代码推理，2026年8月初开放

​

方案一：一键脚本自动配置（⭐ 新手首选）

​

1.1 执行脚本

​

1.2 交互式操作步骤

1. 输入你的 sk- 开头 API Key，回车确认
2. 在菜单选择目标模型（推荐 deepseek-v4-flash）
3. 等待脚本自动执行完成

​

1.3 脚本自动执行任务

• ✅ 自动备份原有配置：~/.codex/backup-deepseek/，支持一键还原
• ✅ 自动生成模型元数据 models.json
• ✅ 修改 config.toml，保留原有MCP、项目信任配置，仅新增DeepSeek服务商配置
• ✅ 配置语法前置校验，出错不会修改本地文件

​

1.4 脚本复用能力

• 切换当前使用模型
• 一键恢复官方原生 Codex 配置（菜单第3项）

​

方案二：手动配置（进阶 / 自定义需求）

​

2.1 创建模型文件 ~/.codex/models.json

作用：向 Codex 声明 DeepSeek 模型上下文长度、工具调用、推理档位等底层参数

{
  "models": [
    {
      "id": "deepseek-v4-flash",
      "object": "model",
      "created": 1700000000,
      "owned_by": "deepseek",
      "context_window": 128000,
      "max_tokens": 8192,
      "supports_tools": true,
      "supports_parallel_tool_calls": true,
      "reasoning_efforts": ["low", "high", "max"]
    },
    {
      "id": "deepseek-v4-pro",
      "object": "model",
      "created": 1700000000,
      "owned_by": "deepseek",
      "context_window": 128000,
      "max_tokens": 8192,
      "supports_tools": true,
      "supports_parallel_tool_calls": true,
      "reasoning_efforts": ["low", "high", "max"]
    }
  ]
}

​

2.2 编辑配置文件 ~/.codex/config.toml

# 全局基础参数
model = "deepseek-v4-flash"
model_provider = "deepseek"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"
model_catalog_json = "~/.codex/models.json"

# DeepSeek 服务商接口配置
[model_providers.deepseek]
name = "deepseek"
base_url = "https://api.deepseek.com/"
wire_api = "responses"
experimental_bearer_token = "填入你的sk-开头API Key"

​

2.3 核心字段速查表

​

各客户端使用方法 & 生效判断

​

3.1 Codex CLI（终端工具）

cd 你的项目文件夹
codex

​

3.2 ChatGPT 桌面端

1. 完全关闭软件后重启
2. ✅ 生效标识：顶部模型选择框显示「自定义」

​

3.3 VS Code Codex 插件

​

常见问题排查

​

Q1：切换 DeepSeek 后历史对话消失

• 原因：Codex 会话按登录方式分组存储（官方账号会话 / 第三方API会话互不显示）
• 解决：运行一键脚本恢复原生配置即可查看旧对话；切换配置后必须重启客户端刷新列表

​

Q2：想恢复原始官方 Codex 配置

​

Q3：客户端识别不到 DeepSeek 模型

1. 客户端最低版本要求：0.144.0，低版本不兼容
2. 确认提前运行过一次 Codex，本地存在 ~/.codex 文件夹
3. 检查 API Key 无空格、前缀为 sk-
4. 重启客户端软件

​

Q4：两款模型如何选择

​

安全与使用注意事项

⚠️ 重要提醒

1. API Key 安全：明文存储在本地，禁止上传 Git、分享他人，避免额度被盗
2. 路径说明：全平台统一配置目录 ~/.codex/，路径写法无需区分 Windows/Mac/Linux
3. 功能兼容：完整兼容 Codex 原生能力——文件修改、代码检索、并行工具调用、项目智能代理
4. 网络要求：脚本执行失败优先检查网络连通性
5. 推理强度建议：推理强度越高，Token 消耗越多、响应速度越慢，新手默认 high 即可